home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / MINT / KEMD.ZIP / KEMD / KEMDINST.TXT next >
Encoding:
Text File  |  1997-01-30  |  15.3 KB  |  452 lines

  1. 1-28-97              **************************************       1-28-97
  2.                      |                                    |
  3.                      | KGMD STEP BY STEP, EASY TO INSTALL |
  4.                      |             K.ELLIS                |
  5.                      |                                    |
  6.                      ************************************** 
  7.  
  8. =-=- FIRST -=-=
  9.  
  10. (1) Get KEMD.ZIP, unzip it, then very carefully read all the texts BEFORE
  11.     proceeding.
  12. (2) Get INSTFLPY.ZOO.
  13. (3) Get the whole folder BASIC.
  14. (4) Get the whole folder NET.
  15.  
  16. *Note* if the link from my page is too slow to get the files with
  17. CAB/Lynx, try the direct Ftp address. Or try the ftp  nic.funet.fi
  18.  
  19. (5) Put all these files in one folder, called KEMD for instance.
  20.  
  21. Thus it will be like:
  22.  
  23. any GEMDOS (atari) partition\KEMD\basic.aaa
  24.                                   basic.ab
  25.                                   basic.ax
  26.                                   net.aa
  27.                                   net.ab
  28.                                   net.ax
  29.                                   instflpy.zoo
  30.           
  31. (6) Now on C drive, or your boot drive, create a folder called multitos.
  32.     (Leave it empty for now)
  33.  
  34. (7) Unzoo the file INSTFLPY.ZOO in the folder KEMD with -e as parameter.
  35.     (-e is to expand the archive).
  36.  
  37. (8) Replace the files from the KEMD.ZIP into the main folder KEMD.
  38.     Thus the files, SETUP, MINT.CNF, KGMD.TXT and README.NOW.
  39.  
  40. (9) Make sure your boot was clean, meaning no extra auto programs or 
  41.     accessories loaded at boot time.
  42.  
  43. (10) Run the program KGMDINST.TOS by double clicking on it.
  44.     (A few questions will be asked)
  45.  
  46. =-=- Questions Asked -=-=
  47.  
  48. This is self explained, so no need to spend an hour on it.
  49.  
  50. (*1) Hostname is just the name of your machine, call it whatever 
  51.      you like, "Falcon" or "Station1" for instance ... You choose..
  52.  
  53. =-=- Next -=-=
  54.  
  55. (1) Copy the correct MINT.PRG depending the machine you have from 
  56.     minix/boot to your boot partition (usually C) /auto.
  57.  
  58. (2) Copy the content of the minix/boot/multitos folder into the 
  59.     /usr/multitos folder.
  60.  
  61. (3) Rename the file MINTKGMD.CNF into MINT.CNF in the /usr/multitos 
  62.     folder.
  63.  
  64. **NOTE** When I say MINIX, I mean the partition that KEMD would have 
  65.          created during the installation.
  66.  
  67. (4) Now you can Reboot.
  68.  
  69. (5) Check that MINT.PRG is at the end, in the auto folder.
  70.     (use autosort.prg to resort your auto folder if you need)
  71.  
  72. =-=- OPTIONAL: Installing an AES -=-=
  73.  
  74. (1) Copy the AES on C. (to be more practical).
  75.  
  76. (2) Edit the file C:\MULTITOS\MINT.CNF
  77.     Add the lines SETENV AESDIR c:\your aes folder path. 
  78.      (not the executable, just the path.)
  79.     Add all the other setenv that you know, for instance if you use the 
  80.     excellent desktop THING, you should add the line:
  81.     setenv THINGDIR path of THING directory (not the executable again, 
  82.     just the directory where THING.APP is located)
  83.  
  84. (3) You should add on to the line setenv PATH \bin;\usr\ucb these paths 
  85.     more, ;\sbin;\etc;\usr\sbin;\usr\local\sbin;\usr\local\bin
  86.  
  87. (4) You might also want to remove the drive A from U drive by adding the 
  88.     line: ren u:\a u:\.a
  89.     This will rename the drive a into .a , therefore U drive will not 
  90.     ask for a floppy everytime you open U drive.
  91.  
  92. (5) Change the line cd u:\ by cd c:\
  93.     and the line INIT has to be with regular partitions, not the minix 
  94.     one. For instance INIT=c:\multitos\init.prg instead of the u path.
  95.  
  96. **NOTE**: save the files MINT.CNF with the standard IBM/ATARI standard
  97. (CR+LF). (from now on, for every UNIX files, you have to save the files
  98. without the CR, so find the option in your text editor where you can 
  99. save in LF only(unix standard))
  100.  
  101. (6) Edit the CNF file of your AES to set it up correctly, like some paths etc.
  102.  
  103. (7) reboot with mint
  104.  
  105. (8) edit the passwd file with vi editor: type vi /etc/passwd to do that.
  106.  
  107. **NOTE** vi is a tricky text editor the first times you use it. 
  108.  
  109. (9) In this file change all the names tcsh or sh to bash. Bash would 
  110.     be easier to load the AES (windows style vs text based) the first 
  111.     couple of times. 
  112.  
  113. (10) Reboot again in Mint. (the changes you made will be effective that 
  114.      way)
  115.  
  116. (11) To load the AES, be on the CONSOLE (alt F10), login as root and 
  117.      type the path+aes.sys (actually it could be any aes, n_aes.sys or 
  118.      gem.sys or whatever the aes you use)
  119.  
  120. **NOTE** The aes is only loadable from the CONSOLE(alt f10).
  121.  
  122. **NOTE** Your atari is separated into Virtual consoles and one main 
  123.          CONSOLE. The V.consoles are accessible by typing alt f1 to 
  124.          alt f9. The CONSOLE is on alt f10.
  125.          
  126.          If you didn't edit the /etc/ttytab file yet, you only have 2 
  127.          V.consoles available + the CONSOLE. You can change that to add 
  128.          more. Copy the driver you want from 
  129.          minix partition/boot/multitos into the bootdrive/multitos, for 
  130.          instance PPP requires the drivers socket.xdd and slip.xif. The 
  131.          driver minix.xdd being previously copied should stay there also.
  132.  
  133. ** TIP **
  134.  
  135. If you want to load the AES directly launchable from the login prompt 
  136. in the console, add the following line in the file /etc/passwd.
  137. gem::0:0:The AES:/home/root:/full path of the aes with the executable. 
  138.  
  139. Thus, typing gem at the prompt as login it will load the aes 
  140. automatically without even asking for a password.
  141.  
  142. **NOTE** The AES user is considered as root and has the same power and
  143.          privilege.
  144.  
  145.  
  146. =-=- OPTIONAL: How to setup PPP -=-=
  147.  
  148. (1) From the folder /etc/ppp/samples, copy the file home-dot-ppprc into 
  149.     /home/root and rename it as .ppprc
  150.  
  151. (2) Copy the file chat-script also into the folder /home/root and rename 
  152.     it .chat-script.
  153. (3) you have to change the protection of this file, type:
  154.     chmod 600 .chat-script
  155.  
  156. =-= Edit the file .ppprc to fit your setup =-=
  157.  
  158. (A) You should change the modem port:
  159.  
  160. -If you have your modem in the modem 1 port then the port would be from 
  161. now on /dev/ttya
  162.  
  163. -If you have your modem in the modem 2 port then the port would be from 
  164. now on /dev/ttyb
  165.  
  166. (B) Adjust the speed of your modem. 
  167.  
  168. (C) You need to call your internet provider and ask them for the MTU 
  169.     and MRU for your PPP account. Most of the time it will be 1500 or 
  170.     1006. And most of the time MTU=MRU. 
  171.  
  172.     If nothing else is added in this file, the default values would be 
  173.     MTU=MRU=1500. 
  174.  
  175. If you have a provider with values=1006 like me, you have to add the 
  176. lines in the .ppprc file:
  177. MTU 1006
  178. MRU 1006
  179.  
  180. **NOTE* The MTU value is not necessary the same if you connect as 
  181. SLIP or PPP. So if you asked the MTU to your provider for SLIP, it 
  182. could be a different number with PPP, ask them again, 
  183. but now ask for PPP !!! ;)
  184.  
  185.  
  186. =-= Edit the file /home/root/.chat-script =-=
  187.  
  188. (A) change the atd by your regular command that you type to connect to 
  189.     your provider. 
  190.     (For me it's ATDT354900 for instance)
  191.     (This number is a telephone number by the way.. Just to make sure...)    
  192.  
  193. (B) Now the tricky part, try to know the login sequence and how to 
  194.     engage the PPP protocol.
  195.  
  196. For me, I have to type my login name with a P in front of the login name
  197. to set the protocol to PPP, but some providers expect you to type PPP 
  198. for protocol. Just use a terminal program, dial the telephone number and
  199. see how the provider login sequence works.
  200.  
  201. **TIP** 
  202.  
  203. Don't enter the whole line expected. For instance, if your provider 
  204. says login or password, don't use the whole name, just cut the start, 
  205. otherwise it could not login correctly..
  206.  
  207. for instance:
  208. ogin: your login name
  209. ssword: your password    
  210. rotocol: PPP
  211.  
  212.  or another example, 
  213.  
  214. ame: your login name
  215. key: your key
  216. rotocol?: PPP
  217.  
  218.  or without the protocol line if it asks you to login as Plogin like 
  219.  I said.
  220.  
  221. For example, mine is:
  222.  
  223. ogin: Pkellis              <- even if my login name is only kellis,
  224.                               the P means that it will start the 
  225.                               session with PPP protocol
  226. ssword: my password
  227.  
  228.  
  229. =-= Setting up resolv.conf =-=
  230.  
  231. (A) rename the file /etc/resolv.conf.sample as /etc/resolv.conf.
  232.     In this file should go the domain name and their DNS number. 
  233.     you have to ask your provider for this.
  234.  
  235. For instance, mine is: domain primenet.com
  236.                        nameserver 198.68.32.10
  237.  
  238. **NOTE** You can NOT invent or create this number yourself! 
  239.          You have to ask your provider. 
  240.  
  241. (B) Rename the file /etc/domainname.sample to domainname.
  242.  
  243. (C) Edit it and replace your domainname. it should be at the end of your 
  244.     email address most of the time.
  245.  
  246. for me it should be primenet.com
  247.  
  248. if your email address is joe@aol.com, then you should put aol.com as 
  249. domainname.
  250.  
  251. (D) Do a symbolic link from the V.console between /usr/etc/inetd and 
  252.    /etc/inetd  by typing: ln -s /usr/etc/inetd /etc/inetd
  253.  
  254. (E) Now, edit your /etc/rc.net.
  255. The two lines with ifconf and route add must be edited into that:
  256.   
  257.   ifconfig lo0 addr 127.0.0.0 up
  258.   route add 127.0.0.1 lo0
  259.  
  260. leave the rest like it is.
  261. ( for some reason, KGMD switched the 2 addresses)
  262.  
  263. =-= Checking to see if PPPD is working =-=
  264.  
  265. (*) (re)boot into mint, 
  266.  
  267. (A) login as root in a V.console ( alt F1 for instance).
  268.  
  269. (B) Type pppd
  270.  
  271. (C) See if the modem connects or not.. (pppd is a program, the dialer
  272.     for PPP actually.)
  273.  
  274. (D) if it connects, look into the CONSOLE (alt F10) to see the log 
  275.     sequence. If it is successful, it should give you 2 different 
  276.     addresses, local and remote..:)
  277.  
  278. **NOTE**: The log file for the PPP connection is in /var/log, like 
  279. that you can trace the history of your PPP connection.
  280.  
  281. (E) Edit the file /etc/hosts
  282.  
  283. It should be:  127.0.0.0 localhost loopback lo0 loghost
  284.                127.0.0.1 hostname
  285.  
  286. (the hostname being the hostname you took before, Falcon for me or 
  287. Station1 or whatever you took, see (**NOTE**)) so replace the hostname
  288. there by the one you chose.
  289.  
  290.  
  291. =-=- How do I know if my setup works? -=-=
  292.  
  293. 1) try to ftp from the Vconsole 1 (alt f1).
  294.  
  295. to do that, type: ftp ftp.cnam.fr  and see if it does anything..
  296.  
  297. login : anonymous
  298. password: your email address.
  299.  
  300. (A) if that works you can go into the directory /pub/Atari and get cool 
  301.     software for the internet, irc II, gopher, lynx Aftp in GEM, etc etc..
  302.  
  303. (B) if it doesn't work, you'll have to mess with the files more..:(
  304.  
  305. (2) try to type:  finger your email address and see what it says..
  306.  
  307.  
  308. *=-=- Troubleshooting -=-=*
  309.  
  310. (P) The modem won't even dial
  311.  
  312. (A1) reboot again without hsmodem and see if it's better.
  313.      if HSmodem was the problem then you need to find the good order
  314.      in the auto folder.
  315.  
  316. (A2) try to see if the modem itself is well configured..
  317.      By typing at&v in a terminal program like ConNect or Stalker, it 
  318.      should give you all the information about your modem. Check with 
  319.      your modem manual.
  320.  
  321. (P) Everything is fine but I can not use ConNect or stalker with mint..:(
  322.     what should I do?
  323.  
  324. (A) Well, the ports are redirected with mint from the boot 
  325.     partition:\multitos\mint.cnf file, with the command ren modem2 ttyb 
  326.     for instance. Let say that conNect really wants to see the modem2 
  327.     available to be able to work, then just don't use the command ren 
  328.     that will rename it totally, but replace it by sln instead, like 
  329.     that it will create a link between modem2 and ttyb, thus keeping 
  330.     the modem2 available and ttyb that mintnet needs.
  331.  
  332. (P) KGMDINST.TOS locks up when creating a minix partition
  333.  
  334. (A1) If it locks up in the middle, I've found that it seems to trash
  335.      the partition. Though this is not the case all the time. If it is,
  336.      It has to be rebuilt (ICD's ICDFMT.PRG for instance)
  337.  
  338. (A2) If you are creating a minix partition over an already exhisting 
  339.      minix partition and it gives you /minix/: permission denied, then
  340.      you will also have to rebuild the partition before attempting to
  341.      install again. (This will be listed with it displays the partition
  342.      contents to you)
  343.  
  344. ***NOTE*** Rebuilding the partition.  I use ICD PRO's ICDFMT.PRG to do 
  345. this myself. Basically, you have to find a way to turn it back into a
  346. GEM/BGM partition (with completely rebuilding the FAT, etc) 
  347.  
  348.  
  349. =-=- UPGRADE -=-=
  350.  
  351. Now, Mintnet should be installed... but only version 0.7.
  352. You might need to upgrade it. (recommended actually)
  353.  
  354. (1) Replace the file PPPD in the folder /usr/etc by the new one given 
  355.     with this doc.. (pppd = dialer)
  356.  
  357. (2) Replace the new slip and socket files given with this doc 
  358.     in the folder c:/multitos .
  359.  
  360. Here you go, mintnet 1.01 is installed now. :)
  361.  
  362.  
  363. =-=- MISC -=-=
  364.  
  365. ***NOTE*** 
  366. If you want to use CAB or the other STIK prg, just get GLUESTIK and 
  367. install it. Programs like Duftp or Aftp don't require Gluestik, by the 
  368. way.
  369.  
  370. ** TIP **
  371. If you want to bypass the filesystem check at bootup to gain speed, 
  372. you can do it by adding the line: touch /etc/fastboot in the 
  373. file /etc/rc.local and reboot twice (or if you can create a null file 
  374. fastboot in the folder /etc then you just need to reboot once, but still
  375. the line touch in /etc/local.rc is needed.)
  376.  
  377. *NOTE* The command touch filename, create an empty file like mkdir 
  378. would create a folder.
  379.  
  380. At the boot up sequence, the system looks for a file called fastboot 
  381. in the folder /etc. If it finds it, it will bybass a lot of tests.
  382.  
  383. **NOTE** the mint.cnf given with the KEMD package is only meant to be used 
  384. by the INSTALL.TOS prg..
  385. **NOTE** on a machine <4 meg of RAM, try to avoid things like NVDI and 
  386. big accessories.
  387.  
  388. =-=- A few commands in the UNIX world -=-=
  389.  
  390. - The TAB key is an automatic completion.
  391. if you type for instance cd /etc/ali [press TAB key]
  392. It will complete the ali by aliases. Try it you'll understand. 
  393. -cd to change directory.
  394. cd .. to go up in the tree.
  395. cd / will go at the root of your unix partition..
  396. so for instance if you are in the directory u:/usr/local/bin/ and you 
  397. want to go in the directory u:/bin just instead of having to go up in 
  398. the tree by typing cd .. cd .. etc, just type cd /bin
  399. test it you'll understand...
  400.  
  401. -ls to display what's in the folder.
  402. like the command dir under MSDOS.
  403.  
  404. -cp is to copy a file, just use it like that: 
  405. cp path+filename source path+filename destination
  406. for instance: cp text.txt /usr/local/text.txt
  407.  
  408. -mv is to move files, used like cp.
  409.  
  410. -chmod xxx filename is to change the protection level of a certain file or folder
  411.  
  412. -ln -s path\file1 path\file2  is used to make a symbolic link.
  413. It will copy the file at the other path without taking the same 
  414. amount of hard drive space :) thus you can have a 1 meg prg linked 
  415. everywhere on your hard drive and still take a very small amount of disk space..
  416. Very useful.
  417.  
  418. -free to see the memory (RAM) and the block of free RAM.
  419.  
  420. -ps to see the prg installed (the PID,STATUS, Size, time, name etc..
  421.  
  422. -kill pid will terminate/kill/exit the prg associated with the pid read 
  423. with ps. for instance kill 68 , if 68 is the PID associated with the 
  424. control panel then it will close this accessory.
  425.  
  426. -top to see the presently running programs in real time.
  427.  
  428. -rm filename to delete a file.
  429.  
  430. -rm -r folder to delete a folder.
  431.  
  432. -vi filename to call the vi text editor with the filename as file to edit
  433. or create.
  434.  
  435. -gunzip filename.tgz to unzip a tgz file. The result would be 
  436. filename.tar
  437.  
  438. -tar -xvf filename.tar to untar the tar archive..Thus to have the 
  439. original files.
  440.  
  441. **NOTE** For the other commands you should open the /bin folder and see what are 
  442. the prg and try them or with --help as parameter. For instance ls is 
  443. more powerful then we could imagine, type ls --help to see the help 
  444. associated with it.. For the other commands, a unix manual would also 
  445. be helpful.
  446.  
  447. Any comments to kellis@primenet.com
  448.  
  449. Personnal thanks to the author of KGMD, SWE, LP, Matrixx and the others on
  450. IRC.
  451.  
  452.